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GENERAL 


The OMS INQUIRY facility is a convenient method by which a 
terminal can be used to extract information from a database 
produced by the DMSII data management system. 


2 7 a t 

The inquiry language enables nonprograamamers to utilize the system 
with Little trainings yet retains the ability to perform very 
complex funct tons. At the same times the language contains 
constructs for compacting complex operations into simpler» 
“single-identifier “macro calls". This flexibility» along with 
gore powerful record selection capabilities» allows this facility 
to be useable in a wide variety of applications. 


Section 1 contains the design objectives and a~ general 
description of the features. 


Section 2 is intended as an introduction to the use of the 
system. The inquiry capabilities are presented by the extensive 
use of examples. . 


Section 3 contains the formal definition of the inquiry 
capabilities. In addition» it contains a formal definition of 
other features intended to aid and/or simplify a user ?s. terainal 
interface to the system and the database. 


RELATED PUBLICATIONS: 
NAME NUMBER 
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DESIGN OBJECTIVES 


LANGUAGE INIERFACE 


Le ODNS/INQUIRY is an on-line interactive inquiry facility. 
While intended for programmer user jit is simple enough that 
with some training it could be easily used by nonprogrammers. 


2. OMS/INQUIRY can extract information from any part of a 
database regardtess of the couplexity of the database. 


3. OMS/INQUIRY takes advantage of any indexing Structures i f 
possibles in extracting information from a data base. 


&e ODYS/INQUIRY always produces the requested information even 
ifs to satisfy the request» it is necessary to do linear file 
searches. While this may take some time» an answer can be 
produced sooner than a user can designs Program and debug a 
program that will satisfy the same request. 
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Se OMS/INQUIRY allows a terminal user to interrogate the 
description of a database. 


Ge OMS/INQUIRY has been kept. as Piaete as ppgeeabtes commensurate 
with previous objectives»s by miniaizing the number of 
statement types. This has been.accomplished by defining 
basic functions which can be connected utilizing English-like 
connectors and/or qualifiers to form complex inquiry 
statements. 


TERMINAL USER*S INTERFACE 


1- The terminal attributes (i.e.» page sizer tine-width» etc.) 
are. known to OMS/INQUIRY. This allows appropriate output 
formatting by OMS/INQUIR¥Y without requiring the user to 
specify these at run time. | 


2- The tanguage' provides a faci1ity for the user to display or 
aiter terminal attributes. . 


, GENERAL SYSTEM FEATURES 


The DMS/INQUIRY facility assumes that the user has a basic. 
familiarity with the structure of the data base. For examples he 
must know the names of the items he wishes to display or test; 
if esbedded structures are employed» he must know the “nesting 


tevel™ of the structures he references; he may need to know 
structure names for item qualification if the system is unable to 
determine from context which structures are required. The user 


may enhance his famittiarity with these and other aspects of 
physical structures if necessary» by means of certain inquiries 
which show the description of selected portions of the data base. 


The most basic operation of DMS/INQUIRY is to select a record 
from the database and print vatues of certain items in that 
record. The users by associating disptay lists and selection 
conditions with structures of the ddtabase>» can control the 
gsanner in which records are selected and the frequency and amount 
of information printed at his terminal. 


DMS/INQUIRY makes it easy to modify» extend or ref.ine previously 
specified selection conditions or display lists. The user may 
subset structures into smaller collections of data with common 
propertiess and restrict subsequent attention to the subsets. 


The user may define “virtual items” which are functions of actual 
or other virtual items; virtual ttems may be used Like actual 
items for selection or display purposes. 


The data base administrators»e through the  DASOL remaps and 
logical data base facility, can protect against unauthorized 
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access to sensitive data by defining which parts of a data base 
have inquiry capability and which users have access to each part. 
An additional tlevelt of protection is available through the 
specification of vatid inquiry users of each logical database. 


A brief description of the OMS/INQUIRY statements follows: 


ATIACH 


Allows the user to combine an embedded structure with its owner 
to establish automatic looping between the two structures. 


CLEAR 


Discards DEFINE items» VIRTUAL items» and/or GENERATEd subsets. 


DEFINE 
Allows INQUIRY text to be assigned a name.w When INQUIRY sees the 


define name» it replaces the define name with the associated 
text. 


DETACH 


Separates an embedded structure from .its owner to prevent 
, automatic looping between the two structures. 


DISPLAY 


Allows items of a selected record to be displayed. 


EDIT 


Allows a previous INQUIRY statement to be ‘modified without 
requiring the entire statement to be re-entered. 


GENERATE 


Creates a temporary subset of a data set. The temporary subset 
can be referenced by other INQUIRY statements. 
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HELP 


Displays the syntax and semantics for each INQUIRY statement. 


NEXT 


Causes INQUIRY to resume record selection and item display. 


ORILONS 


Altows INQUIRY options to be disptayed or altered. 


PRINIER 


Allows the attributes of the line printer file to be displayed or 
altered. : : De 


QUIT 


Terminates the INQUIRY session. 


RECALL 


Retrieves the text of a prior INQUIRY statement. 


REPEAT 


Causes re-~execution of a previous INQUIRY statement. 


RESTORE 


Allows previously SAVEd text to be retrieved. 


SAVE 


Stores the text of DEFINE items» VIRTUAL items and GENERATEd 
subsets ina file on disk. The SAVEd text can be reloaded and 
used during subsequent INQUIRY sessions. | 
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SELECT 


Locates records which satisfy the selection criteria provided by 
the user. 


S£T 
Modifies or deletes the text of the most recently entered 
DISPLAY» REPEAT or SELECT statement for a given data set. 

SHOW 
Displays all or selected portions of the database description and 
aay aiso be used to display the most recently entered INQUIRY 
statement. 

SORT | a ; ; 
Allows a user to control the amount of core and disk used by the 


SORT option. 


TERMINAL 


Allows the attributes of the terminal file to be displayed or 
altered. | 


VIRTUAL 


Allows new jgtems to be defined which are functions of other 
items. ' 
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OPERATING INSTRUCTIONS 


ACCESSIBILITY 


The DMS/INQUIRY facility provides the ability to specify which 
portion of a data base is to be visible to any particular user.. 
The user may be allowed access to the entire data base or any 
Single logical data base. The method for specifying accessiblity 
is defined in Appendix A. 


TERMINAL USE 


Log-on procedures are defined in Appendix Ae Once tlog-on has 
been accomplished the user may then enter inquiry statements. 


The terminal attributes are known to DMS/INQUIRY aillowing 
appropriate output formatting without the user having to specify 
them at run time. 


Terminal input is received by DMS/INQUIRY one line at a time with 
the line width being determined by the type of terminal and the 
TERMINAL WIDTH option. The maximum Line width may not exceed 
that of the terminal being used. . 


In some cases an inquiry statement may require entering an input 


which exceeds the line width capacity of the terminal. For this 
reasons the system maintatns a current text buffer capable of 
holding several lines of input. While the text of some 


statements is processed’directly in the input oufferr the text of 
other statements 18s moveac to and then processed from the current 
text buffer. Those statements whose text is moved to the current 
text buffer are: 


DISPLAY 
SELECT 
GENERATE 
SET 
DEFINE 
VIRTUAL 


For the above statements» -if the text associated with the 
Statement exceeds the maxiwua that can be entered in one liner a 
Z can be entered just ahead of the end-of-message character. 
When the system responds with a #i» additional input can be 
entered. This can be repeated until the complete statement has 
been entered. 


If it is desired to enter an input and have the system “remember™ 
the text but not process its the line of input Cor tast tine of 
input) may be ended by a %% just ahead of the end-of-message. If 
the input is incorrecte it can be corrected with an EDIT 
Statement (See EDIT). |. The REPEAT statement can be used to cause 
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the system to. process or reprocess the contents of the current 
text buffer» while the SHOW statement can be used to display the 
contents of the current text buffer. 


The current text buffer can also be toaded with previously 
entered text (See RECALL). 


Certain abbreviations are allowed for the DMS/INQUIRY statements. 
Below is a list of statementss the underlined portions represent 
the sinimum recognized abbreviatian. 


ATTACH NEXT . 7 SAVE 


CLEAR OPTIONS SELECT 
DEF INE. PRINTER os SET 
DETACH our | SHOW 
DISPLAY RECALL _ SORT 
EOLT | | REPEAT TERMINAL 
GENERATE RESTORE VIRTUAL 
HELP 


Some input commands may produce an excessive amount of output. 
This output» shown one page at atime» can be ciscontinued by 
entering a non-null response after a page has been displayed. 

The system will then respond with a %#" indicating that it is 
ready for user input. © ; 


BASIC ENTITIES 

Letters consist of upper case A thru Z and lower case a thru z. 
ALL lower case tetters are Efapsteted: to upper case except when 
used in alphacliterals. : 


Digits consist of 0 thru 9. 


Nages» unsigned integers» ‘numbers and alpha-literals are formed 
as specified in the DASDL Product Specification», 2219 0433. 
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Names include those of accessible data base items» DMS/INQUIRY 
keywords» alt possible valid abbreviaticns of the verbs» virtual 
iteas» define items» temporary set and file names. 


Alphacliterals need not» in. some circumstancess be contained 
within quotes. When the OPTION QUOTES = FALSE» atpha-numeric 
strings will be. considered as alphacrliterals if they are not the 
same as any data base items virtual» define or temporary set 
names. 


DATA RELATIONSHIPS 
The data relationships of a data base can be represented by a> 
hierarchy or tree structure. Each data set with its embedded 
data sets is said to be a tree structure. For a given data set 
Y» each possible ordered set X of elements Xi where 

Xi = Y 

Xi. is embedded in Xi-1 for i < i <a 


Xn has no embedded data set 


is said to be a branch of the tree structure for Y. 


UNIQUENESS GF NANES 


Names of database itess not inctuded in the user's logical data 
base may be used to identify other DMS/INQUIRY objectse 


Define formal parameter names may be the same as any other name 
except any define formal parameter in the same parameter list. 


File names may be the same as any other name. 


DMS/INQUIRY keyword names may be the same as a data base item 
nage. when there is a conflict in interpretation of use 
DMS/INQUIRY assumes the nama to be of a data base item. A "3° 
preceding the name may be used to cause OMS/INQUIRY to assume the 
reserved word usee 


With the exceptions above» temporary set» virtual and define 
nages must be untque. 
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BASIC INQUIRY 


The process of producing information on a user's terminal 
consists of two functions: 


ae Setection of those records of interest. 


be Displaying user specified information from these records on 
the user*s terminal. 


For examples suppose a company had a data base which contained 
information on the company’s employees. If the user enters 


SELECT ROOM = 42k 
the system would locate the first record for an employee residing 
in Roem 421. If the system fails to locate at least one such 
records it will type out 

# NOT FOUND 
If the system does locate a records it wilt type out only the #. 
If the user now wanted some informations such as the person's 
name and extension numbers he would enter 

DISPLAY NAME>» EXTENSION 
The system would respond as fellows: 

NAME = JONES JOHN O 

EXTENSION = 2364 


If the user wishes to know if more than one person resided in 
Room 421» he could then enter 


NEXT | 
If another record existed» the system will respond by typing a #. 
If no more records exist» the system will respond with a # NO 
MORE. | 

SELECT 
The text» ROOM = A2le in the example — 

“SELECT ROOM = 421 | 
is a selection-condition. 
The sinplest form of select ion-condition is tn the fora: 


name retationatl-operator value 
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Example: 
SALARY > 500 
JOBCLASS = “PROGRAMMER™ 
HOURS“WORKED < 40 
In the above Ganaptes: the cKaracters >» =» < are relational 
operators. The’ following table indicates allowable relational 


operators. 


. Alternate 
Operator Spetling : Meaning 


Se Hot Ghee eee See eee Behe tee Gesu eee 
= | EOL EQUAL TO 
> GTR : GREATER THAN 
< ESS _ LESS. THAN 
<=5 > LEQ LESS THAN OR EQUAL To 
“>=p 7< | GE@ GREATER THAN OR EQUAL TO 
n= | NEG NOT EQUAL TO 


The logical operator NOT together with parenthesis can be used to 
specify an “all except" condition. 


Example: 
SELECT NOTCJOBCLASS = “MANAGER” ) 
would select all people except these who are managers. 


The togical operators AND and OR can be used to combine simple 
conditions into more coaplex conditions. 


Example: 


SELECT DEPT=6790 AND JOBCLASS="MANAGER®™ 
SELECT DEPT=6700 OR DEPT=6800 


Care must be taken when using the AND and OR both within the same 
condition. 


Examples: 
SELECT DEPT=6700 AND JOBCLASS="PROGRAMMER™ OR SALARY > 500 


This select statement woula lecate all records in DEPT=6700 where 
JOBCLASS was programmer. Also it would locate all persons whose 
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SALARY>500 regardless of department. The reason for this is that 
AND is always performed first. 


Parenthesis can be used to controt which conditions are ANDed 
with other conditionse For exampte: 


SELECT DEPT=6700 AND (JOBCLASS="PROGRAMMER" OR SALARY>500) 


This. select statement would tocate only those people in 
DEPT=6700» who are programmers or whose salary exceeds 500. 


QUALTFEICATION 


A data base consists of one or more data sets. Each data _ set 
‘consists of anumber of recerds where each record consists of a 
number of items. In the preceding examples» it was not necessary 
to name the data set containing the records to be selected. The 
OMS/INQUIRY wilt attempt to determine the data set name by 
analysis of the names appearing in the item list and/or the 
selection condition. This is not possible in all cases. For 
examples consider the following: a 


INVENTORY DATA SET 
UNIT“PRICE 
PART“NO 

ORDERS DATA SET 
UNIT“PRICE 
PART-NO 


In this case two data sets have records with the same item names. 
A request to 


$ELECT PART“NG = 1234 
would cause DMS/INQUIRY to respond with: 
@ WHICH DATA SET? 


Te INVENTORY | 
2. ORDERS 


The user would then respond by. entering either 1 or 2. 


The user can designate the correct data ‘set at the time the 
DISPLAY is entered. 


Exaaples 


SELECT PART“NO OF INVENTORY=1248 
DISPLAY UNIT-PRICE OF INVENTORY 
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QUALIFYING SELECTION EXPRESSIONS 


To determine the object dataset of a selection expressions the 
left sides of alt retationats in the expression are analyzed to 
produce an object dataset. The VIA structures if specifieds is 
included in this analysis. In the case where this analysis does 
not yield one unique possibility» OMS/INQUIRY will attempt to 
choose from the multiple pcssjbilities by applying: 


1. its knowledge of the structure of the database» and 


Ze its knowledge of past references to the database through 
DMINQ statements. ae 


CHECK CURRENT HIERARCHY 


The object dataset .of the last selection expression processed 
will be used in the first. attempt at qualification. DMS/INQUIRY 
will first assume that the present selection refers to: 


1. the same dataset as the Last selection expressions or 
Ze a dataset embedded tin that dataset. 


Should both of these criteria fail to reduce the number of 
possible object datasets» DMS/INQUIRY will proceed by considering 
the parent dataset of the last dataset selected. The same test 
as above will be applied. The datasetr then its immediate 
descendant datasets» will He checked to determine whether they 
can qualify the selection expression. This process of checking 
the current “branch of the tree" continues until: 


le one of the criteria causes the number of possible object 
datasets to decreases or : 


2e the disjoint level is redched>» and fails to reduce the 
number of possible object datasets. 


If OMS/INQUIRY has reduced the number of possible object datasets 
at any of the steps above» it will ask the user to choose _ from 
among those possibilities which remain. If a singte dataset 
remainse OMS/INQUIRY wilt use it as one object dataset of the 
selection expression in question. 


CHECKING PAST DATASET REFERENCES 


Should the above procedure fatl to produce one unique obdject 
dataset» DMS/INQUIRY wilt choose as the object dataset the 
dataset which was most recentty referenced in a DMS/ILNQUIRY 
statement. Areference to a dataset consists of using any 
expressions which» ‘in order to be evaluat eds requires that 
dataset to hawe a valid current record. 
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ASKING IHE USER 


If the above two methods fail to yietd one unique object dataset» 
the user will be asked to choose from among the possibilities. 


QUALIFYING ITEMS IN SELECTION EXPRESSIONS 


Once OMS/INQUIRY has determined the object dataset of a selection . 
expressions any item names appearing in multiple datasets must be 
qualified. The procedure of qualification is simitar to that for 
qualifying selection expressions» as it uses both the current 
hierarchy and the recora of past references to the database. 
DMS/INQUIRY will first try the assumption that: 


1. the item is in the object. dataset of this selection 
- expressions 


then try the assumption that: 


2e the item is in a dataset in the current “branch of the 
tree", . 


If these criteria fail to yield a unique parent dataset for the 
item» OMS/INQUIRY will choose as the possible parent dataset the 
possible dataset which was most recently referenced by a 
DMS/INQUIRY statement. If the above also fails» the user wilt be 
asked to supply explicit qualification. 


QUALIFYING FUNCTIONS 


The process of determining the object dataset of a function 
selection condition is again similar to the two qualification 


resolution processes explained above. The basic difference 
occurs when the function aoes not reference an embedded dataset 
at the next lower level from the current object dataset. then 


DMS/INQUIRY is unable to choose an object dataset on this basis» 
it with immediately assume that the object dataset of the 
function ties outside the current "branch of the tree" and will. 
preceea to the checktng of past references to datasets. 


SIRUCTURE DESIGNATION 


For each data set in a data base» there may be a number of sets 
and subsets associated with it. The system witl always attempt, 
if possible,» to locate selected records by utilizing index sets. 
It will never automatically utilize subsets to locate records as 
subsets may not locate all the desired records. 
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The user mays however» force OMS/INQUIRY to locate records 


through a given structure. For example» given a data set with 
sets and subsets as follows: 


PERSONNEL DATA SET 
NAME ALPHA (17) 
MANNUM NUMBER (5) 
DEPT NUMBER (4) 


EMPNUMSE? SET OF PERSCNNEL KEY MANNUM 
DEV eee SUBSET OF PERSONNEL WHERE ‘DEPT= 6700 KEY NAME 


The statement 
SELECT MANNUM=28901 

would use the AUTOMATIC set EMPAUMSET to tocate the record» while 
SELECT NAME="DOEs» JOHN" . 


would cause the file PERSONNEL to be searched. The system would 
not use DEPT&700> as this structure is a subset and may not 


 focate allt of the requested records. 


- The user may force the system to baeeke records in the order of a 
particular structure. For example: 


SELECT PERSONNEL AT MANNUM>590 


would cause DMS/INQUIRY to locate recerds through the data set in 
physical storage order. 


SELECT EMPNUMSET 


would cause OMS/INQUIRY to tocate att records sequentially 
through the automatic set EMPNUMSET. 


SELECT DEPT67090 AT NAME=IDOE>o. JOHN* 
would cause the system to select records through the subset 
CEPT6700 (which for this example would locate only those JOHN DOE 
who are in department 6700). 
DISPLAY 
Once a record has been selected by the user» he may wish to 
display one or more items within the record. . This is 
accorplished by utilizing the DISPLAY statement. © 


Example: 


SELECT ROOM=421_ 
z 
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DISPLAY NAME 
*NAME=SMITH JOHN 

DISPLAY EXTENSION 
*EXTENSION=2364 

DISPLAY DEPT 
*DEPT=6145 


Notes * denotes system response but in actual use does not 
appear on the user’s terminal. 


As indicated by the above example» once ae record has been 
selected» one or more DISPLAY statements are allowed. 


More than one item can be displayed by entering a List of desired ~ 
items. . 


Exaaple: 


SELECT ROOM=421 
# 

DISPLAY NAME» EXTENSION» DEPT 
*NAME=SMITH JOHN 
*EXTENSIGN=2364 
*DEPT=6145 


When displaying an item List» a comma must appear between the 
names of the jtems in the item list. 


If ait is desired to display all itens in arecords the user can 
enter ALL. 


Exanple: 

DISPLAY ALL 
This will dasplay alt itess in the most recent ly-selected 
structure. 
COMBINED SELEET/OISPLAY 
The process of record selection and item display can be combined 
into a single inquiry statement by adding a selection condition 
to the DISPLAY statement. 

DISPLAY NAME IN ROOM=421. 
In this example the word IN separates the item list of the 
display from the selection condition. In addition to the word 
IN» the words AT and WHERE cdn be used as separators» as well as 


the special character de 


Examples: 


BURROUGHS CORPORATION we COMPARY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP | --B1800781700 DMS/INQUIRY 
SANTA BARBARA PLANT | BS Se 2222 2566 REV. A 


DISPLAY SALARY AT MAN-NUMBER=2890 
DISPLAY ROOM WHERE EXTENSION=2364 
DISPLAY EXTENSION 2 ROOM=421 . 


“a structure designation is required» this. designation can be 
inserted just ahead of the separator. 


Exaeple: 


DISPLAY UNIT“PRICE USING ORDERS WHERE PART-NO=1248 


PROCESS TERMINATION 


The commands SELECT/DISPLAY» GENERATE» REPEAT» SHOW and HELP may 
generate an excessive amount ef otttput or require an excessive 
amount of system time. The processing and/or output of these 
statements may be terminated by entering a nonvsnult response 
after a page full of ainformation has been displayed. 
The status of DMS/INQUIRY after such a termination is not 
defined. . 


QUIPUT CONTROL 


Hhen using SELECT as a statement» the user gets one record at a 
time. To obtain additional records which satisfy the criteria of 
the selection=-condition»s the NEXT statement must be used. 


The system's response to a combined select/disptay inquiry 
statement» howevers is to dasptay the information for alt records 
selected without further intervention by the terminal user» 
unless the terminal is a CRT device. For CRT devices the system 
will display that amount of information which will fill the 
screen then watt. At this point the user can have the system 
present another screen full of information by entering "NEXT" or 
an endcrof-message. If the user. enters anything else the inquiry 
is cancelled. 


The output produced by an inquiry may become excessive for 
printing on the terminal. The: amount of uninterrupted output can 
be controlled on a statement basis. 
Example: 

DISPLAY 3 NAME IN DEPT=6700 
The systea will display output for 3 records» and then waite 
Entering NEXT will either disptay the rematning output» or 


display the output for 3 more records and then wait again. 


An alternate method for entering NEXT is to enter only the 
end-of-message. i - 


crc oo oe 
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EMBEDDED SIRUCIURES 


In a data base it is passible to have datasets appear as itess of 
records of another data set. For example: 


D DATA SET 
Di NUMBER 
D2 ALPHA 
E DATA SET 
E1 NUMBER 
E2 ALPHA 


D3 NUMBER 


In this example» E is an embedded data set of D and O is the 
parent of E. D is also considered a disjoint dataset as it has 
no parent. Another case of embedded structures is as follows: 


D DATA SET 
D1 NUMBER 
D2 ALPHA 
SE SUBSET OF E KEY El 
D3 NUMBER 
E DATA SET 
El NUMBER 
E2 ALPHA 


The subset SE is an embedded subset of D which points at some or 
all of the records of the disjoint dataset E. 


Several cases exist for inquiry against embedded structurese For 
each of these cases» the following dataset is assumed: 


0D DATA SET 
E DATA SET 


F DATA SET 
‘F2 


D 1s a data set containing items Di» D2» 03 and the embedded data 
set E. E£ is an embedded data set containing items El» E2>» E3 and 
the embedded data set F. F ts an embedded data set containing 
items Fi and F2. . 


a7 sa 
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DISPLAY ITEMS OF EuBEOQED STRUCTURES 
Exaapltle: 
| SELECT D1=3» THEN DISPLAY E1lwE2 WHERE €3>5 

This exampte wilt select all 0 records where D1=3. For each D 
record selectede the system will display El and E2 for each €E 
record where £3>5. 
If structure designation were required» the exaaple would be 

SELECT D WHERE D1i=3» THEN DISPLAY E1-E2 USING E WHERE £3>5 
Items of F could be displayed as follows: | 

SELECT D1=3- THEN SELECT E3>5» THEN DISPLAY Fl AT F2=7. 
One could disolay atead from each data set. 
Example: | | 


DISPLAY D2 WHERE Dl=3» THEN DISPLAY €1 WHERE £3>5+ THEN 
DISPLAY Fi AT F2=7_ | 


The output appearing on the terminal would be 


D2 = 28 
Ei = 4 
Fi = 7 
El = 6 
Fi= 3 
Fil = 10 
Fl = 14 
Ei = 7 
E1 = 8 
Fl = 18. 
D2 = 30 
El = 8 
Fl = 4 
Fl = 8 


(until there are no more 0D records). 


For this example the item is displayed before the ‘system attempts 
to locate a record at an embedded Level. 


Since each record must be located before an attempt is made to 
locate a record of an embedded structure» the item list ina 
DISPLAY may reference items of records at previous levels. 


Example: 


SELECT D1=3» SELECT E£3>5» DISPLAY D2» El» FL WHERE F220 
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Note: Either a comma» or THENs or both aust be used to separate 


clauses in a coaplex inquiry statement. 


This example differs froa the. preceding example in that a DISPLAY 
will accur only if a record exists at all levels. 


The above exampte may require qualification of the displayed 
items by the data set name» as the item name may exist in the 
records of more than one datasets i.@e» 7 


e e e DISPLAY O02 OF Ds» £1 OF Eo» Fi OF F 


QUIPUT CONTROL 

The system» in response to an inquiry» will output results until 
all records selected are displayed Cor the screen of a CRT device 
is full). 


The amount of uninterrupted output can be controtied on 4a 
Statement basis. For example: 


2 SELECT D1i=3 THEN DISPLAY 3 E1 WHERE E2=7. 
For this example the 3 after the DISPLAY will cause the system to 
output items for 3 records of E>» then wait.  $Qutput can be 


continued by entertng NEXT. 


The use of the output control numbers can atso be used to 
selectively bypass some of the output. 


Example: 
SELECT D1i=3 THEN DISPLAY 3 E1 AT E2=7 


The system wilt display €1 for 3 records of E and stop. If the 
user then enters NEXT 0 the system witl 


ae Cancel output for E records of the current D record. 
be. SELECT the next D record. 
¢. Output the first 3 € peeves setected. 
Output control can be imposed at each level. 
Example: oe. | 
DISPLAY 3 D1 AT 02=5 THEN DISPLAY 2 El AT E2=7 
The system will stop steer displaying 2 E1*s. It will also stop 


after caisplaying 3 Di*s. This may require entering NEXT twice to 
resume output. ; 
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ARITHMETIC EXPRESSIONS 


In the previous examples the selection conditions presented were 
alt im the fora 


name relational-operator value 
CeJe 


Dl > 5 
D3 = 7 


The systems in addition to numeric and alphabetic literals» also 
allons arithmetic expressions in selection conditions» e.g. 


Bil > D2+D3 
D4 < (€€02403)*«D4)/05 
07 > D8 


The arithmetic operators allawed in these arithmetic expressions 
ares 


+ add 

= subtract 
* multiply 
7 divide 


DIV integer divide 
MOD modulus 


The rule as to what identifiers may appear in an arithmetic 
expression is: atl the terms appearing in the expression gust be 
capable of yielding a value when the record containing the item 
to the left of the relational operator is loaded. 


For example» given the database: 


‘Dp 
D1 NUMBER 
D2 NUMBER 
D3 NUMBER 
E DATA SET 
El NUNBER 
E2 NUMBER 


e7~k0d 
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LEGAL exasples | 

SELECT D1 > D2 

SELECT D3 > (014D2) 

SELECT VIA D» SELECT E2 > £1401 
ILLEGAL examples 


SELECT D1 > DItE2 


Note: A vatkue for £2 cannot be derived as no E record has been 
selected. 
EUNCTIONS 


Sometimes it is necessary to select a master record as a result 
of some function of its embedded dataset. 


BOOLEAN FUNCTIONS 
For example» suppose for each employee there is an embedded 
dataset containing job history information. Suppose it 15 
desirea to know the names of everyone tn DEPT=6700 who has been 
an ENGINEER. j 
Example: 

DISPLAY NAME WHERE DEPT=6700 AND ANYCJOBCLASS="ENGINEER™) 
The condition 

ANY CJOBCLASS="ENGINEER® ) 
is a Boolean function as it yields a truth value 

TRUE or FALSE. 
The system will select only DEPT=6700 records. For each of these 
selected recards»s the system will search the employee's job 
history looking for a job class of engineer. If any are found»s 
the system will display the employee’s names. 
The condition within the parenthesis may be a comptex condition. 


Example: 


ANYCJOBCLASS="ENGINEER™ AND TIMEHELD=18) 
ANY CJOBCLASS="ENGINEER™ OR JOBCLASS="MANAGER™) 


The second form of the Boolean function is ALL. For example, 


DISPLAY NAME WHERE DEPT=6700 AND ALLCJOBTITLE="ENGINEER™) 


Go a 
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This example would display the names of all personnet’ in 
DEPT=6700 who have onty held positions of ENGINEER. 


ARITHMETIC FUNCTIONS 


Suppose there is a BANK data set. Each bank record has an 
embedded STOCK data set which contains information about stock 
the bank ownse A tist af banks which own more than $1+%000»0060 in 
stock is required. 


Exaaple: | 
| DISPLAY BANK-NANE WHERE SUMC STOCK=VALUE) > 1000000 
The expression 
SUMCSTOCK-VALUE) 
9s an arithmetic function. In addition to SUM» the system allows 
AVERAGE» MAX» MIN» SUM OF SQUARES» MEAN SQUARE» VARIANCE and 


STANDARD DEVIATION (see FORMAL DEFINITION (Section 3) for 
details). 


In the above example» the STOCK-VALUE items for all STOCK were 
summed» then compared with the specified value. -A condition can 
be specified which allows selecting only some of the records to 
be summed. | 


Example: 


DISPLAY BANK<-NAME | 
WHERE SUMCSTOCK@"VALUE ‘WHERE TENDOR="ABC™) > 1000000 


This example would disp tay bank=-names for those banks which owned. 
more than $1%000%000 in Company ABC. 


A special type of arithmetic -function is the COUNT. COUNT will 
count the number af occurrences af some condition within the 
embedded datasete For example: 

DISPLAY BANK~NAME WHERE COUNTCTENDOR="ABC™) > 9 


This example would display the names of banks owning more than 9 
stock certificates in ABC Company. 


cas 
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FUNCTION OLSPLAY 


Arithsetic functions (but not Boolean functions) may also appear 
in the display item List. 


Example: 
DISPLAY BANKNAMEs» SLMCSTOCK-VALUE) FOR STATE =. "NEW-YORK" 


Khen using FUNCTIONS within a selection condition or disptay 
List», it must be remembered that at least one term associated 
with the function must be tn a4 dataset embedded within the object 
dataset of the SELECT/DISPLAY expression. Given a data base 
which contains: = 


D DATA SET 
D1 
D2 
-E€ DATA SET 
£1 
E2 
Legal: 


DISPLAY Di» SUMCEL) AT D2>0 AND AVGCE2)>50 
Not legal: 
DISPLAY El» SUMCD2) 
as D2 is not in a dataset embedded in £. 
Qne can always . 
DISPLAY AVGCSALARY)» MINCSALARY) 
where salary is an item of the disjoint dataset PERSONNEL. 
Caution: To compute the vatues for the various functions it may 
be necessary “for the system to access every record of 
the dataset involved; thus it may take some targe 
amount of time to produce a result. 
MIRTVAL LIEMS 
It is sometimes desirable to compute and/or display a value which 
is not physically held in the database. For example it may be 
desirable to display a person's weekly salary but only 


HOURS“WKORKED and PAY“RATE is held in che dataset. 


The concept of Virtual items 1s implemented to handte cise For 
@xampte the system allows 


Teles UM ES ape AR Wie gee meee me me me meee nee Bal Rene, EI ES 
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VIRTUAL SALARY = HOURS-“WORKED*PAY-RATE 


The system would remember SALARY and treat it as if SALARY were 
_an actual item. The user can then use this virtual item in a 
display item list or selection condition. 


Example: 


DISPLAY NAME» SALARY IN OEPT=6700 
DISPLAY NAME» DEPT AT SALARY>409.00 


Any form of arithmetic expression is allowed to the right of the 
"EQUAL™ sign in the virtual text. The rule is that the ttems 
must te capable of yielding a result when the virtual item is 
referenced. For example» given the database which contains 


D DATA SET 
D1 
D2 : 2 
E DATA SET . 
El 
E2 
Given: 
VIRTUAL DX = 014D2 
VIRTUAL CE = £1+D1 
Note: Since 0 exist when E exists» the virtual DE can contain 


items of D and F. 


Legal: 
DISPLAY OX AT D2 = 59 
Not legal: 
DISPLAY DE AT D2 = 50 
Note: Since E does not exist when OD exist the E item CE1) 
cannot be part of the virtual DE. . A record not selected 


error will occur. 


The arithmetic expressions associated with a virtual may also 
contain arithmetic functions. For exaaple 


VIRTUAL OX 
VIRTUAL OY 


Ci+SUMCE1 AT E2>20) 
AVGC(E2) 


It is advantageous in terms of system efficiency to associate 
arithmetic functions with ¢irtual identifiers. If a function 
appears. in a display item list or selaction conditions the systen 
must evaluate the function each time the function is referenced. 
Howevers if the function is associated with a virtual» the system 
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“remerters” whether a function has been evaluated and» if sop the. 
value of the function. 


Note: The system also recognizes when the vatue of such a 
function becomes meaningless and witl re-evaluate it when 
necessary. ' 


UNDEFINED IIEMS (values print as hyphens) 


There are several cases where references can be made. which can 
result in undefined situations. These cases may occur either in 
a display List» a selection canditions or ane arithmetic 
expression. The undefined cases are as follows: 


ie The value of an item is NULL (as defined in DASDL). 
2. The value of a function is undefined. for example? 
AVGCE2 where £1>100) 
and there are no records where £1>100. 


3. Variable format records are used and a record was loaded in 
: which the specified item does not exist. 


4. The process of evaluating an arithmetic expression would have 
resulted in division by CG» or an attempt was made to generate 
a number exceeding the hardware capacity Cinteger overflow» 
exponent averflows, or exponent underflow). 


When an undefined situation is encountered in displaying an items 
two hyphens are printed in lieu of a value. 


The occurrence of an undefined situation becomes slightly more 
coaplex when encountered within a selection condition. For 
exanple 


SELECT NOTCA=B) OR C>59 
if either A or 8 is undefined the setectional expression 

NOTCA=8) 
is false regardless of the presence of the NOT and regardless of 
the relational operator used. The record would be selected only 
dependent on the truth value of the relational expression C>5". 


However if C-was also undefined» for the current record being 
looked at» then the record would not be setected. 
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UNSUGTED ALPHASLITERALS 


When entering selection conditions in various inquiry statements» 
relationships in. the form: 


<ALPHATID> <RELATIONAL> <ALPHA-LITERAL> 


are encountered. ALPHATLITERAL is defined hy a quote (*)- 
followed by one or more characters» followed by an ending quote. 


Example: "THIS IS AN ALPHA“LITERAL 


One of the most frequent terminal user errors: is to fail to 
bracket ALPHA-LITERALS by the beginning and ending quotes. 


The INQUIRY system will recc§nize alphanumeric strings as alpha- 
numeric literals even though quotes are not used. 


Note: An- alphanumeric string is defined as a series of 
characters containing cnly lowercase A~Z» uppercase A-Z 
and the numeric characters 0-9. Special characters are 


not allowed. 


However » stnce the use of unquoted -alpha-literals can be mis- 
interpreted ty the system (discussion follows)» the fotlowing 
option can be utilized. 


Dee- OPTION QUOTES annem nn nn tenn nn nn nn nn nnn nnn nnn nen nnn --->7 


i i io FALSE "ere s>.| 


1. If quotes or quotes = TRUE» then all alpha-literals: must be 
quoted. This is the default set on initializing INQUIRY. 


2e If quotes = FALSE then 


ae An alphanumeric string will be recognized as an 
alpha-literal when used in the proper context. 


b. <Alpha-literails containing special characters ($%&) and 
blanks must be quoted. 


Ce Even if quotes = FALSE» quoted alpha~literals are 
atlowed. _ 


As previously stated» the system may misinterpret the user intent 
when unquoted alpharliterals are used. For the foltowing 
discussion and examples» A represents an _ alpha identifier in the 
data set D-. , : 
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Exaaple 1: 


“1234 
12A856 


SELECT A 
SELECT A 


An unquoted alpha-literal whith starts with numeric characters 
wild not be misinterpreted. 


Example 2: 
SELECT A = X13 
X13 is the name of the data base iten. In this case the system 
cannot know if the user wanted the vatue of the identifier X13 or 
the alpharliteral "X13". The system will assume that request was 
for the identifier. 
Example 3: 
DEFINE X13 = RST an 
and then 
SELECT A = X13 
The system will see this as if the user had entered 


SELECT A = RST 


If the atphanumeric string is the name of a define, the define 
will be expanded and the text of the define used. 


‘Two eateduards bya ct which can be used to determine if the systea 
will recognize the user intent. 


ae If a SHOW X13 is entered and this results in an unknown 
identifier or invatid option errors then X13 will be accepted 
as an alpWa~literal. . . . 


be. Given that a selection expression has yielded unexpected 
results» entering a ; 


RECALL D 
where D is the data set name» will indicate what was scanned 


by the system as any unquoted alpha-literal will be 
redisplayed as a quoted alphacrtliteratl. 


ot 
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QUIPUT FORMATTING 


The display of data on the terminal is under. the controt of the 
getting of the TERMINAL FORMAT attribute HEADING» TAB and SINGLE. 
CSee TERMINAL verb in section 3). 


The default setting when more than one record is being displayed 
is HEADING. 


The default setting when only one record is being displayed is 
TAS. 


HEADING 
This format attribute can be set by entering 
TERMINAL FORMAT HEADING | 
The output display will be in the forms: 


Ni N2 NB 
Vid viz  vi3 
V21  v22  -v23 


where Ni» N2 and N3 are the names of the items and 


V11 is the value of Ni in recerd 1 
~W12 ais the value of N1 in record 2 
etc. 


In some cases the size of the disptay List witl be such that all 
the names and/or values wiil not fit on one line. For this case 
the output will be in the form: 


12N1 N2 N3 
22N4 NS N6 
1svil vl2  V13 
2:Vi4 Vi5S  V16 
1sv21  v22.v23_ 
22V24 v25  vV26 


where Nil thru N6_ are the names of the items and the Vij are the 
values of the items. : 


Association between names and values ‘is made by line number and 
position Within the Line. | 


The number of title lines and value lines for a single record may 
be such thats» for acrt devices the screen would not be tlarge 
enough. The first time the system detects this it witt 
automatically reset the FORMAT attribute to TAB. 
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This format attribute can be set by entering 
TERMINAL FORMAT TAB 
The output display will be in the fora:. 


N1=V1 N2=V2 N3=V3 
N4=V4 N5=v5 


The intention of the TAB format is for the case where the display 
list output cannot fit on one screen. Each name = value 


combination will start at a TAB position where the TAB stops are 
every Sth position starting at character position 2. 


SINGLE 
This format attribute can be set by entering 
TERMINAL FORMAT SINGLE 
- The output display is in the “orm: 
N1=Vi 
N2=V2 
N3=V3 


That is one name and vatue per tine. The intention of the SINGLE 
attribute is for those terminals which have small Line widths. 
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DMS/INQUIRY DEFINITION 
STATEMENTS 


ATTACH 


le ATTACH is used to combine a structure with its owner’ to 
provide automatic selection tooping between the two 
structurese . 


2. Data-set-id» e.gen Xir must be an embedded structure already 
specified in a SELECT/DISPLAY command (this implies that Xi-1! 
has also been previously specified). . . 


36 “Subsequent to this command» whenever a record is selected for 


Xi-i>» a record will be automatically setected for Xi. In 
additions whenever Xi is exhausted» Xi-l wilt be 
automatically selected. Thus» this command “joins” the two 


structures. | 

4e Note that Xi is by defautt attached to Xi-ip if- both 
Structures are given in the same SELECT/DISPLAY command and 
are not subsequently DETA€Hed.« 


Se If Xi is already attached to Xi-l» this command is ignored. 
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CLEAR --n----""= DECLARATIONS -oeeee anne nn mene nnn ene n en nc en ene= ># 


1. 


i i 
[e----=- GENERATES -------- en-n------ -->1 
. i 
poo2es wan VIRTUALS ~~ cess wor owcooea= > | 
i i 
be------ DEFINES -------- en eeeeen------>] 
i t | | 
( im-- <define-id> ->! 1 
i ; . i 
fore coee Kjid> esr esr eweees cme wecww oes ae >I 


The CLEAR statement causes the system to clear the text 
declared by a CEFINE» VIRTUAL» or GENERATE statement. 


The keyword DECLARATIONS causes the identifier and text» 
established by all VIRTUAL» DEFINE and GENERATE statements, 
to be removed from the inquiry system's set of identifiers. 


If the keyword VIRTUALS>» GENERATES» and/or DEFINES is used, 
the system will clear. all text of all identifiers declared by 
that verb. For the special case 


CLEAR DEFINES <define-id> 
only the <define~id> will be cleared. 
If <id> is used» it must be the name of an identifier 
established by a DEFINE» VIRTUAL» or GENERATE statement. 


This <id> and its text wilt be removed from the inquiry 
system's set of identifiers. 
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DEFINE 


Option 1: 


DEFINE -<--<-- <definewid> =<" = “2= <text> coerce eennnenennena>y 


Qption 2: 


<= » =~! 
i ] 
OEFINE =" <define-id> -*- ( -=-<par>“-er2e ) == = |= <text> -->8# 


1. DEFINE establishes the given <define~id> as an abbreviation 
for the given text. 


2e Option 2 is the parametric define. It allows a portion of 
text to be defineds with the resaining portion being supplied 
at the time the <define id> is referenced. The <par> is a 
name meeting uniqueness requirements. For example: 


DEFINE GETCA+B8) = DISPLAY NAME AT A = 8 


The identifiers A and 8 are formal parameters. When the 
<define-id> is referenced» the text which appears in the 
position of the forgwal parameters is inserted into the define 
text at the position where the formal parameters appeare For 
example: 


GETCEXT+ 2364) 
will cause the systen to “see™ the statement: 
DISPLAY NAME AT EXT = 2364 
3e References to defines may appear anywhere a name may appear. 
However» file names and formal parameters are not treated as 
references to define~ids- 
4s The text of the define may contatn references to other 
defines. A define say not contain a reference to itself and 
the referenced define text may not contain any define 


referencase 


3 Text for a previously established define may be changed only 
by: ; ; | 


a. CLEARing <define-id> and re-entering the DEFINE» or: 


Sie | 
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b. RECALLing DEFINES <define-id>» EDITing and REPEATing. 
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DETACH 


DETACH cremmmtnnn enn <datamset-id> censor renee meen een n nn nnnn>s 


1. DETACH is used to separate a structure from its owner in 
order to prevent automatic selection looping between the two 
structures. 


2- The <data~set-itd>» e@.ege» Xi» must be an embedded structure 
' already specified tm a SELECT/DISPLAY command (this implies 
that Xi-l has also been previously specified). 


3- ‘Subsequent to this command» whenever Xirl is selected» Xi 
wilt be marked as having no current record setected; 
whenever Xi is exhausted» the system stops with an 


appropriate message. 


4. Note that Xi 8 by default attached to Xi-1 tif both 
structures are given in the same SELECT/DISPLAY command. It 
is necessary to OETACH Xi to prevent automatic selection 
looping between the two structures. . 


5. If Xi and Xi-1. have been previously specified» but in 
different SELECT/DISPLAY commands» and if they have not been 
subsequently ATTACHed» they are by default DETACHed. 


6. If Xi is already detached from Xi-1, this command is ignored. 


on 2 
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DISPLAY (Current) 


DISPLAY “eres Sesere= <disptlay=li st> os=9s<sssssSSesees see se=<-=>% 
is | a, i 
' : i 
6 | i 
Per= ALL weeens~ OF mmm <datawset“id> =~-->1 
( i 
i t 


1. Display on the user’s éerecnat the values of: 
ae Items specified by the <display tist>;s or 
Db. Mek. Gens of <data-set-id>» if given? or 
ce ALL items of the most recently~selected structure. 


“2. All items to be displayed must be contained in structures for 
which there are current records selected. Referencing other 
items will result tin an error. Items need not all appear in 
the same branch of the data base. 


3- Note that this command is a special case of the general 
. SELECT/DISPLAY command. No setection conditions are givens 
and no change is made in the status of any structures nor in. 

the selection conditicns or display-lists» if any» attached 

to any structure. | 


4&4. The ALL option means to display all items of the record. If 
the OF <dataw~set~id> is not specifieds then the items of the 
record Last selected wilt be disptayed. 
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FOIr 


EDI T-s*---— <delim> ="- <textil> --- <delim> cote ceeeeecennnnn--># 
= i | t t 

! f= <text2> -->1 
REPEAT >I | 


le EDIT allews saodification of the current text buffer of the 
BDMS/INQUIRY system (see SHOW and RECALL). 


2. EDIT searches for the Literat appearance of <texti> itn the 
current text buffer. 


3. If <text2> is not specified» then <textl> is eliminated from 
the current text. - 


he If <text2> is specified» then <textl> is replaced by <text2>. 


5. The delimiter <delim> can tte any special character not 
appearing in <textl>. 


6. The REPEAT verb can be followed by the EDIT syntax; this is 
identical to EDIT... foltowed by FEPEAT. : 
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GENERATE 


Im <temp-set-exp> --7>1. 


<temp-setrexp> 


Steap “Set S1.d> SoS e Sess seseeess esses se Ses SSS Sass as Sse Sssee=e=28 

( ; j 

tmn- AND wor" <temp~set~id> <-->] 

t I 

fe-- OR --=->1 

{ i 

i--- + 22>) 

i t 


1. Generates a temporary subset of structure Xe 


ae satisfying the given <select-spec>» or 
: be. equal to another temporary subsets or 
; Ce equal to a set furction of two other temporary subsets. 


2. The temporary subset se generated may be subsequently 
referenced by the given <temp~setcid>. It may be used 
wherever X may be used. 


3e Alt temporary subsets used must be subsets of structure X. 
The two <temp~set-id>s in the <temp-setrexp> must be 
different. 


4. The permissable set functions are? 


AND =: set intersection 
OR : set union 

- ¢ set difference 

+ 3: exclusive OR 


S3- For details of <select~spec> see SELECTION CRITERIA. 


6- X. must be a disjoint structure. 
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HELe 

ee t. ] 

q . . , | 

Poem - VERB test st eset es er ses cess wc ommoenan) | 

q 1 | 

f--= <verbrname> ---=->1] f-- SEMANTICS =->1 

! | 


te-- <syntaxcitesg> =“->1. 
1. The HELP verb supplies information to a user on how to use 
OMS/INQUIRY. 


2e If HELP is entered following an error outputs» the system will 
display an explanation of the error encountered. 


3e HELP VERB will display a list of all inquiry verbs. — 

&. HELP <verb-name> will display the syntax diagram of the verb. 

5. HELP <syntax-item> will display the syntax of the syntax 
item. Note: a “syntaxcitem™ is any name appearing between 


"<<" and *3" in any syntax diagrame 


6. If the SEMANTICS option is used> then the semantics will be 
displayed instead of a syntax diagram. 


7- Any <verb-name> or <syntaxcitem> must be spelled exactly (no 
abbreviations). ; 


86. The file DMS/HELPING must be present. 
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NEXT 


Option 1: 


NEXT SSO SS BTBSSE HD RTS DSBHHBSHBAHAABET eA F8 Wee Ssaweweensaonansewoaaouweanoaw) § 


= i i 
ber" <data-setrid> “<-->! 


Option 2: 


NEXT se aneecae sete ance esas @ ? Sees Ss See Se 2 eee SS eee ses a eee => fF 


Qotion l 
1. Continue the selection of records as previously speci fied. 


2- If no <data-msetrid> is given» continue the selection process 
of the most recent command at the point at which it stopped. 


3. If <data~set-id> is givend e.ge» X» continue the most recent 
command which selects X at the point where it selects a 
record from xX. This need not be the point at which the 
command had stopped. ; 


Qption 2 


1. NEXT? asks the system to display the name of the next data 
siet to be selected if NEXT is entered. . 
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QPILONS 


bom= TERMINAL toeer econ ne nn nene cnn nncnnrenen-->] 


! i 
Pm-= COMMENTS cone n nen en nn nnn ne nnnnnnsenrenn=>] 
! | i 
Im-- NULL ceeen=>1 0 fnes = <2" TRUE --"--->1 

i t ‘ t 

Im-- QUOTES ---->1 i- FALSE <-->! 


OPTIGNS. allows a user to control certain actions during his 
session. ye te 


TERMINAL causes output from DISPLAY statements to go to the 
user's terminal. This action remains in effect until PRINTER 
is set. TERMINAL ts set by default during initialization of 
INQUIRY. 


PRINTER diverts output from DISPLAY statements to a printer. 
This action remains in effect until TERMINAL is set. 


Setting TERMINAL or PRINTER can be done at any time. 


COMMENTS or COMMENTS = TRUE causes the quoted comments to be 
displayed along with identifiers when using the SHOW command. 
COMMENTS = FALSE suppresses the display of those comments. 
COMMENTS is FALSE by default. 


NULL = FALSE will. NOT display the names of items whose value 
is NULL when TERMINAL FORMAT TAB or SINGLE is used. 


NULL or NULL = TRUE the default) disptays all items 
regardless of value. 


QUOTES or QUOTES = TRUE (Cthe default) causes INQUIRY to 
require quote marks to bracket all alpha~literals. 


QUOTES = FALSE causes INQUIRY to recognize alphabetic or 
atpha=-nuweric strings as alphacliterals when associated with 
atpha variables. at 
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PRINTER 
PRINTER ADS One oe RS EEN EOS ECP Cee a ane am asanunaw = ewmconnea>] 


' i 
L$ Seer Sess e Se ses. eases SSS S55 S== iy 
I i 
Eerse= PAGE “<-=s"ese=%<". <integer> ‘==> 1 
i ' 4 i 4 


i §- WIDTH “il i4 = =f i 
' . . 4 
i- FORMAT nen aenaaan saw HEADING onane sm» | 
i - f 1 . i 

{- = =-4 {- TAB see aaa = wa we >4 

i i 

{= SINGLE wena w ean >] 


1. PRINTER allows the user to disptay or alter _ printer 
attributes. 


2e Entering PRINTER with ro other. option wilt result in a 
display of the current printer attributes. 


3- PAGE is the number of lines per page. 

fe. WIOTH is the number of characters per line. 

5. The FORMAT option controls the way data is formatted on the 
printed page. See OUTPUT FORMATTING for a discussion of the 
FORMAT attribute. ; | 


6. The printer attributes are active only if OPTION is PRINTER. 


al a J 
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Qult 

QUIT AS Sete SS Ae ee eee ae ea ees seu ®aaaunee ses een aa nmaanaana=> ff 

le QUIT terminates the inquiry of a database. 

2. Used only when the user is finished.. It its necessary to 
re-initiate DMS/INQUIRY if further inquiry of this or another 
database is desired. , 2 

3e If any text associated with a DEF INE> VIRTUAL» = and/or 


GENERATE statement has been added» deleted or modified» 
entering QUIT will result in the warning: 


# DECLARATIONS NOT SAVED - a 


‘Entering QUIT Cor a null input) wilt resutt in the 


termination of INQUIRY without the text being saved. To save 
the text» enter SAVE Csee SAVE verb)s INQUIRY wilt abort the 
termination process if anything other than QUIT» SAVE or a 
null input is entered at this point. 
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RECALL 
RECALL ---- <data-setrid> crore ee nero ---- 2 oe ae mn aw mo ae oe coe owssanee ># 
mam | : ; i 
| [=>- <eupesetsies —Sefasaesos= =eee>' 
i | 
fe-- <virtual-id> ------------------>1 
t ‘ 


be-- DEFINE --- <define~id> s"-re7-->] 


1. This verb places the text dssiocraced with identifier into the 
current text buffer. 


2. If <data-set-id> is specified» then the SELECT and/or DISPLAY 
text associated with the data set is placed into the current 
text buffer and displayed. 


3. If <temp-set~id> is specified» the GENERATE text ts placed 
into ne current text buffer and displayed. 


a. If evivtasizaus is specified», “ihe VIRTUAL text is placed into 
the current text buffer and displayed. 


5- If DEFINE <define-id> is specified> the text associated with 
the definerid is placed into the current text buffer and 
displayed. 


6. In all cases» the RECALLed text can be EDITed and REPEATed. 


——s 
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REPEAT 

REPEAT Pewee met eee wna area ase ewon ana sews ease eee ecaae aw  ) ># 

= i 1 


1. 


36 


fe-- <data-set~id» <-->{ 


REPEAT by itsetf will reprocess the current text buffer (see 
SHOW and RECALL). 


It is anticipated that the REPEAT verb will be used following 
an EDIT or RECALL statement. 


REPEAT <data~set~id> will begin the setection process for the 
select and display specifications associated with the 
specified structure as welt as SELECT and/or DISPLAY 
Statements associated with attached» subordinate structures. 
Note that though the owner data set of <data-set~id> is 


‘ attached» there is no automatic selection of the next record 


of the owner. 
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RESTORE 
RESTORE Sane Bee Oe ee Beste Beene BAND waaaawase=> J 
aoe -q : e { | i 
i f ft-- CVERWRITE ~>1 


J wee wee eee ewooesoe~ <file-name> ==>] 
| ' ( 


{woceece * cone we > | q 
m | i | 
f- (€<usercode>) =>] i 
( | 
“t=- £81800-file~identifier> ------>1 


le RESTORE reloads the text from the file previously SAVEd. . If 
the file does not exist» the user will be so informed... 


2e- If the option OVERWRITE ts not used» id's that already exist 
wilt not be overwritten from the file. 


3. If the option OVERWRITE is used» the text associated with 
existing id's which have the same name as id's on the file 
will be replaced from the file. 


4- The verbs SHOW GENERATE> SHOW DEFINES» and SHOW VIRTUALS can 
be used to determine what is loaded. 


Se To reestablish the contents of temporary sets» it witl be 
necessary to RECALL and REPEAT the desired set id's. 


62 The <file-name> is a 10-character file identifier. 


7. ‘The <B1800-file~identifter> is a full = fite identifier 
conforming to 81800 file identifier syntax» specified in the 
MCPII Product Specification. 


8 If an asterisk («*#) is specified» the file is assumed to 
' reside on the system disk. - 


9. If a Cusercode) ts specified» the file is assumed to have 
that Cusercode) as a multifile-id and is assumed to reside on 
the default pack for that usercode. 


19. If the specified file does not exist» OMS/INQUIRY will give 
an error and continue processing. 


baad at 
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SAVE 
SAVE ne ae ee aww aes wate n sas enawosan ase esensataneasewsaewseceen=>f 
i i | 
jf oseere & enveseceu=)> |] | 
‘ | , , 
tm" C<usercode>) -->1 i 
. | i 
t-- <B81800-file-identifier> ---cess<e--%"->)] 


1. SAVE saves the text associated with DEFINE» VIRTUAL and 
GENERATE statements. 


2.2 If * precedes the <file name>> the file saved becomes a 
system file. 


3. If <Cusercode)> precedes the file names the file will be 
saved in the usercode directory. 


4 If neither a * nor a <C€usercode)> precedes the filenames the 
file will be saved in the terminal user’s directory. 


5S. See RESTORE to recover the text SAVEd. 


6- The use of the prefix * or <Cusercode)> may cause the 
: termination of INQUIRY without saving any text dependent upon 
the security clearance of the terminal user. 


7. The  <B1800-file-identifier> is a full file identifier 
conforming to 81600 file identifier syntax» as specified in 
the MCPII Product Specification. 
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SELECT/OI SPLAY 


eoseeeD LSPLAY S99 "<i splay specrs ss sssre eS ss er Seer es ss eces ters acres >% 
Lo ti a | it 
il 7 it 11 
i ‘ot it 
1 PmeSELECT---<select-specr>“->1 In- » --REPEAT<-~<data-set~id>-->1 1! 
| se  - i 
( ! 
t ! 


<saraawensanwoaneowae nse ec ee S QS BF OB Be SB sg eee @e weseeasgewrweeeeyeaae w © =e 


i t { 

j Vv f 

1<- THEN? ---3-e--] 
In the syntax diagram above» each <display-spec> or <select~spec> 
contains selection criteria fer one structure; CaoJe» Xip at 
nesting level i. Assume that the entire command contains 
selection criteria for severat tLevets of embedded structures: 
Xne Xnt1l» ° ° oe §=6—XMe The command specifies the current 
select/display information attached to data set Xi. If the 


cogmand does not specify proper syntax then none of the data sets 
current information is changed. 


The basic action of the command is to select one record from each 
Structure Xt (Cn<=i<=m) which satisfies the selection condition 
for Xi. In additions certain items are displayed on the user's 
terminal each time a record is selected by a DISPLAY clause. 
This action may be repeated automaticatly until atl selected 
structures are exhausted» or» _under certain conditions» the 
action will periodicatty stop and wait for further input Ce.ges 
NEXT) from the user. . 


1. The DISPLAY and SELECT clauses must be arranged so that the 
structure Xi is embedded in Xi-1l for n < i <= om. 


2e The limit» if present» is an integer constant >0. 


3. ALL Xi» ixn> must have already been selected; 1.@.» there 
must be a current record for Xirv X2— «ecw Xnw1le 


4. The selection criteria and display lists for all data sets of 
the tree for Xm Cexcept Xw) are set to empty,» and those 
structures are marked as having no current records. 


5. The <select-spec> or <display-spec> for Xi is "attached" to 
structure Xi. That iss the given selection criteria and 
<display-list>s are remembered for subsequent use. Any 
previous criteria or. lists are discarded. . 


6. Records are selected from the Xi in order of the nesting 
level. For each Xi setected by a DISPLAY clause» items are 
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displayed as soon as the record is selected. This process 


Te 


9e 


10. 


11. 


12. 


13. 


14. 


15. 


(16. 


continues until one record from each Xi has been selected. 

If Xm (the innerawost structure selected) is not selected by a 
DISPLAY clause» the selection process will stop after 
selecting a record from Xm» and wait for further input. 


If Xm js selected by a DISPLAY clause» the system will 
continue to select and display records of Xm. 


If a Limit is associated with any Xi» this value is tested 


prior to attempting to select a new record from Xi. If the 
fimit is exhausted (zero)» the system will stop and wait for 
further input. Otherwise» the limit is decremented and the 


selection process continues. 


If» for any Xi» where i>ne no more records. from Xi satisfy 
its selection criterias the system will select a new record 
from Xi71 and then continue the selection of Xi in the new Xi 
structure. Whenever Xn 18 exhausted» the entire process 
ends. . 


Whenever Xi is selected» the Limit values for atl structures 
embedded in Xi (Xi#1) are reset to their original values. 
Also alt data sets of the tree structure of Xi (Cexcept Xi) 
are marked as having no current record. 


Whenever the system is stopped and waiting for further input» 
the command NEXT Xi Cfcer n<=i<=m) may be emptoyed to cause 
the system to continue the selection process just described 
with the next Xi record which satisfies the setection 
criteria for Xi. Xi need mot be the structure about to be 
selected when the system stopped. Exactly one record is 
Selected from each structure Xi» Kitl>s «ene XMe 


The command NEXT is identical to NEXT Xi» where Xi was the 
next struature to be selected when the system stopped. 


Note that whenever the system stops to watt for further 
inputs a consistent set of records exists as current records», 
one from each structure Xi» X2» over Xivn 1 <=Me 


For purposes of automatic looping» note that the structures 
Xno eee Xm may be considered part of a single set of nested 
loops (Xj is attached to Xjrl» n<j<=m). That is» whenever a 
record of xi» n<=i<me is selecteds records are automatically 
selected for all Xj» i<j<=my» and whenever any Xi» n<i<=me is 
exhausted» a record is selected from structure Xicl. Prior 
to this command» if Xn had already been specified» and was in 
fact attached to structure Xn-l» it is now detached from 
Xn-1e Also if Xmel had previously been attached to Xm» it is 
now detached from Xm (See ATTACH and DETACH). 


The REPEAT clause is used to cause automatic looping outside 
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the normal family of embedded structures. If the REPEAT 
clause (e.g. REPEAT Z) occurs after selection criteria for» 


Say» Xi»e then the REPEAT clause is attached to structure Xi 
(Same as SET Xi to REPEAT 2). £After a record of Xi is 
selected» Z is automatically REPEATed. ALL of tts automatic 
selection and disptay will take placer just as if REPEAT Z 
were entered after the selection of a record of Xi. When the 
REPEAT 2Z action is completed» the processing of the original 
family (Xi) resumes in the normal manner. Note that tf Z is 
an embedded data set ‘that is attached to its owners the 
automatic selection includes only attached data sets embedded 
in Z. The REPEAT may not require record selection from data 
sets at a higher nesting level of the branch X1leceXne Xin Xm 
where X1 is a disjoint data set. 
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SELECTION CRITERIA 


<select-spec> 
Seen ae Karate ee <CONGIt 16>: 22 <s2sSss eh ese sae eee Ss Ssaen eee Sena ss=>> 
| | i 
t t= AT => ' — 1 
i ; i 
foro orowmren= <CStructure*id> sce secrete ecw escces sce seo sescaonecn)> | 
t 1 . | | t 
i VIA =>] i- AT -=- <condition> ->1! 


| | 
feere » SORT s--- <sort-spec> <--->! 


<display-spec> 


Option is 
l ? t I 
Im-<limito->1 i- VIA ==" <structure-id> -->1 
1 ] 


f-- » SORT == <sort~spec> <-->! 


Option 2: 


{ 1 ot { 
i-<limito->Ff $= VIA =>1 


>> www ewe wees ewe ww eam ewee nese ewww enews eon acocowase =e meant eae «a a = ># 
| i.f 1 
Im AT == <condition> =>) U-~ » SORT -- <sort=spec> =->1. 


1. “WHERE"» “IN"» "FOR" and “%2" are synonyms for "AT". 
2e "USING" 18 a synonym for “VIA". 


1. A condition is a general ‘boolean expressions invotving 
<boolean primary>s combined by AND» OR» and Parenthesis (See 
SELECTION CONDITION for details). 


2. Selection criteria may contain either or both of two 
components» the <structure~id> and the <condition>.. 


vy 
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3. If a <structure-id> is specified» that structure is used to 


access records. The <structure~id> may be a data set» an 
automatic or manual subset» a temporary subset or a tink. In 


allo cases» the data set from which the records are ultimately 


read is the structure» (X)» to which the selection criteria 
are attached. Records are accessed in the order of the given 
structure. If a <condition> is not given» att records are 
selected. The keyword VIA is optional in most casess. its 
use aids in the processing of the command>s but it has no 
effect on the meaning of the command. If no structurecid is 
specified (then there must be a condition)» records will be 
accessed ‘by whichever structures the system determines to be 
the most efficient in satisfying the condition. 


The condition specifies certain relationships which must be 
satisfied by items. in a record if that record is to be 
selected (See SELECTION CONDITION}. 


The SORT OPTION allows records to be selected (and displayed) 
in the order of one or more keys. See SORT OPTION for 


details. 


Limit is an unsigned integer q@qreater than 0. 


ne ae. ae 
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SELECTION CONDITION 


<condition> 


§ <2 eres eee esas ewee ene , ANDO ace mae were een ecuae | 


i | | 
POS OS OT OTST POH OSES ASEH SS ES ROSS SHON SDV eanesenaannwen> ff 
ist i 
{ i iv---- <boolean-primary> -->1! 
f--NOTe->) 1: ] 


in-- ¢ --<condition>-- ») =~>1 


<boolean-priaary> 


Pesan ew <aexp> Same es aang aaa wa <relop> — mm <aexpo sa answswawae)> ff 


{-- 
os 


i-- ¢alpharitea> crrrecrree= <relop> -- <atpha-literal> se=>( 


i | 
im <alpharitem> <-->! | 
, i 


where <relop> is 


1. 


2e 


36 


Se 


SPELLING MEANING 

EQL» = CEQUAL) 

NEQs == CNOT EQUAL) 

LSS, < (LESS THAN) | 
LEQ»e <=» ~> (LESS THAN OR EQUAL TO) 
GTR» > CGREATER) 


GEQs» >=5 *< (GREATER OR EQUAL TO) 


The <condition> is a generalized boolean expression 
consisting of boolean primaries ANDed/ORed together. The use 
of parenthesis allows the ANDing/ORing of conditions to form 
complex canditions. 


The ‘<boolean-primary> establishes a truth value dependent on 
the relationship between two values. 


The <aexp> is a general arithmetic expression involving at 


‘least one arithw-item (Ci.@er items of type NUMBER) of the 


record to be selected. 
The <alpha-item-1> is an item (see <item>) of type ALPHA. 


The object dataset of the selection expression wittl be 
determined according to the algorithm specified in Section 2. 


ac 
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6. Precedence of evaluation of logical and arithmetic operations 
is as specified in the DASDL standard. 


a ee “ad 
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DISPLAY-“LISI 


<display-list> 


| deme eet roer ess 9 fee ween ee caseene | 
? , | 
Power eowmmmwwowomose= CITE H> Teter sree ce ew eee wee es ewe sn ee enana=> Zi 
| ] 
f-~- <occurrence"segment> ~>1 
t ee | 
i<eeeses<= <agxo>. =<<9se2<<>'| 


<occurrence=segment> 


fier> 1 | ° : 


f---0F <quali --->8 I- (-"<sub --- TO --<sub -----) ->1 


fier> scriopti> script2> 


1. A <disptay~list> specifies items to be disptayed on the 
user’s terminal. 


2. All items must be contained in the record being selected or 
in data sets having a current record. 


3. An <occurrence~segment> is a short-hand notation representing 
several occurrences cf an occurring items beginning with 
<subscriptil> and ending with <subscript2>. Subscripti. and 
subscript2 must be unsigned integers. An occurring item with 
no subscripts is an <cccurrenece-segment> specifying all 
occurrences of the item. 


he The term <item> includes virtuat items» defined by the 

' terminal user with a VIRTUAL statement. Virtual items may 

not be qualified Call have unique names) and they may not be 
subscripted. ; ‘ 


w_ — ws 
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RORT OPTION 

<sort~spec> 


i | | { 
wren enn neem en ternnnnn- <keyritem> s----s-"- ASCENDING --------># 
' i i ‘ 
I-- ON -->t l---- DESCENDING <-->! 


<key~item> 


i. f 
im <numericritem> ->] 


The keywords may be abbreviated where . the minimus recognized 
abbreviation is the undertined part below: 


1. 


20 


ON ASCENDING 


_ a aa at 


DESCENDING SORT 


The SORT Option allows selecting or displaying records in 
order of a specified key. 


The SORT Option is: specified after the SELECT <condition> in 
a SELECT or DISPLAY stateaent. 


The SORT Option may onty be specified in a selection 
expression for a disjoint dataset. The use of the SORT 
Option wilt cause a SORT/¥SORT task to be generated to effect 
the sort. 


Examples: 


DISPLAY D1l»/D2 AT 03 > 50» SORT ON D4 
SELECT D3 > 505 SORT ON D4e THEN DISPLAY E1l*eE2 AT E3 > 9 


ALL <key-items> must be items in the selected data set. 


Qualificatton of <keyritems> cannot be specified. 


If a <key~item> is an occuring item» it must be subscripted 
by an integer constant. 


The number of <key-items> specified cannot exceed 25. 


a a i Te eens 
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7- The SORT Option associated with a data set can be 
established» modified cr eliminated by use of a RECALL» EDIT 
and/or SE? statement. 


8. The SORT verb can be used to specify core resources to be 
used for sorting. The sort core soecified will control the 
speed of the sort process. : 


The SORT Option functions are as follows: 


1. Each record of the data set that meets the requirements of 
the SELECT-CONDITION ts read from the data base. An entry is 
made in a tag file that consists of the extracted keytitems 
and the data base address of the record. 


2- The tag fjle is then sorted. 


3. INQUIRY then reads the sorted tag file sequentially. For 
each tag entry» INQUIRY reads the data set record at the 
address imgdicated in the tag entry. 


he From this point» INQUIRY wili perform as if the data set 
record was obtained directly from the data set» eege INQUIRY 
will display items or execute the statement associated with 
any attached embedded data set. 


Caution: The user should be aware that» since all records must 
be selected» then sorted» before any display can occur» 
the terminal resfonse may be considerably slower when 
using the SORT Cption. 
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FUNCTIONS 


<boolean function> 


Je 


he 


i i an | 
ALL ~=->I i- <structure ~-"~- WHERE =>! 
-id> 


ANY yields the truth value TRUE if any record in the dataset 
meets the requirements of the conditton. — 


ALL yields the truth .valtue TRUE only if all reccrds in the 
dataset meet the requirements of the condition. 


If the function is referenced at a given nesting level then 
the terms in <condittion> must reference at least one item in 


a dataset at the next Lower nesting level. 


Iff a <structuretid> is specified» then only records retrieved 
via that structure are considered. 


Ld + 
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<arithmetic-function> 


t-AVG-->! ( a | | 
] | I-VIA <structure => I-WHERE <condi =>1 
I-MAX<-->1] id> tion> 

] i 

i-MIN-->1 

t { 

1-SSQ-->1 

1 | 

1-MSQ-->1 

| | 

I“VAR-->1 

t 

i-STO-->1 


IABSosnn ne Cnn <aexp> soccer ) teeter econ erent cee nennenne->] 


» 


i-SQRT=->1 ; i: 


I-COUNT“"-- ( <--<structure id>---9- one nn nn ene nnnnnnnn= ) =->4 


i t t 
i f-"-WHERE“~<condition>-->1 
i : j 


1. For the above functions COUNT and SUM thru STD» - if the 
function is referenced at a given nesting level (excluding 
the disjoint data set tevel) then the terms in <aexp> and 
<condition> must reference at least one item of the data set 
at the next lower nesting level. For alt these arithmetic 
functions» if the WHERE condition is not specified then all 
records are utilized to produce the function value. 

2- For the functions SCALE thru SQRT» the <aexp> may be any 
general arithmetic expression. 

3e If a <structure"id> is specified» then only records retrieved 
via that structure are considered. 

4- ‘The functions are defined as follows: 


ae COUNT - The number of records which satisfy the 
<condition> Cif specified)» or the number of 
records in the specified structure. 

b. SUM - Sum of all <aexp>. 

Ce AVG ~ Average = SUM/N. 
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MAX 


MIN 


, $50 


MSQ 
VAR 
STD 
SCALE CXsF ) 


ABSC(X) 
SQRTCX ) 
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Maximum» i.e.0 the value of the largest 


arithmetic item. 


Minimuge i.e.» the value of the smatlest 
arithmetic item. 

Sum of squares. 

Mean square = SSQ/N. 

Variance = (SSQ*N*AVG*e*2) / (N71). 
Standard deviation = SQRTCVAR).- 

Return the value X scaled to F fractional 
digits by rounding. The non-fractionat digits 
are unaffected. 

Absolute vatue. 

Square roots X >= 0.2. 


The arithmetic function is undefined if no records satisfy 


the condition. 
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ARITHMETIC EXPRESSIONS 


<aexp> 


i<er- <arith-op> ane--------1 
! | ' 


1 { i i 
j--- - “=> jf { | 


where <arith-op> can be 


SYMBOL MEANING 


‘ €ADD) 

- ss SUBTRACT) 

- CMULTIPLY) | ee 

/ (DIVIDE) 
DIV CINTEGER DIVIDE) 


HOD CREMAINDER) 


<arith-primar y> 


Peer StS sN ssa Se Ss CNURer Le" CONnStant> = ss eee oren= esse se sS=5>% 
t i 
jsSerersees= Sar ith-i tea <-sessas- Se sSS=> 1 
i { 
[oreesnnrnn-— <arithmetic~function> s----+7>] 
{ | | ; i 
[Seas cerere= <Vvirtial=1beg> > ssS=9445s=s=> | 


1. The <aexp> is a generalized arithmetic expression. If used 
in a SELECT condition» all arithmetic items must be in data 
sets having current records or in the data set being 
selected. Parentheses can be used to combine arithmetic 
expresstons into more coaplex arithmetic expressions. 


2- A <numericeconstant> is a number. 


3. An <arithritem> is an item in a record of a type which wilt 
yteld a numeric value (See <item> below). 


4e An <arithmeticefunction> is specified in FUNCTIONS (See 
below). 


Se A <virtual-item> is an item established by the VIRTUAL verb 
- @See VIRTUAL). 


BURROUGHS CORPORATION . 7 COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP Bi800/B1700 DNS/INQUIRY 

SANTA BARBARA PLANT Pe Se 2222 2566 REV. A 
LIEMS 

<item> 


| t 3 . I 
f--OF --<qualifier>->1 t= ( “-<subscript>--- ) =>! 
| ] ‘ 


J < eee seem wawancaem fj [<~co-8 , acne] 


1e An <identifier> is the name of a database item. 


2- An <identifier> may be quatified> if necessary» by a 
<qualifier>. 


3-e A <qualifier> is the <identifier> of a data set which 
contains the <identifier>. : 


4. An <item> must be subscripted if it ts defined with an occurs 
clause in DASOL-. 


Se. <A <subscript> is an arithmetic expression (see <aexp>) which 
must yield an integer valwe which does not exceed the DASDL 
defined OCCURS limit. 


i Deere i | 
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i 
1 


REPEAT --- <data-set-id> ---------------->1 

{ i { 

b--- NONE ~-~<---->1 | 4 

( 

i 

SORT “sees "2 <sort=specs —-s-s9s<=<<s-=<>] 
‘ i 
Iseo- NONE ------>1 
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sft 
SET =* <datarsetrwid> sect etcec ces eee ceces cece semen sass enassacee=> ff 
oon 4 . { 
t ; . i 
{KPC S esha see Here see] | 
i ] 
poosscveeesteoe= SELECT --"- <select"spec> s7sssececceesaee=>| 
i a i i | 
| i { | | 
im TO =>! 14 fer" NONE worse" ">1 t 
| i 
-¥-- DISPLAY .---= <display=spec> cesteserere-->] 
4 i | 
4 Poeoesenrecere= <displayclist> -->] 
1 “$4 ' - | 
( 1 i-<tlimnit>->1 {. 
t i . i 
1. pemenrers NONE teeee ewe ecw mmnaa= > | 
| ] 
4-- LIMIT seer rresseeesesese=s <Limit> sss9*+==>1 
1 a 4 i . i. i 
q f-- = =>] f--- NONE -=>1- | 
i i { | 
i i- TO ~>1 ; . t 
f ] 
1 
i 
4 
| 
1 
4 


The SET statement atlows the user to modify or remove the 
<selection-condition>» — <display~list>>, <repeat=spec>» 
<sort=spec> or <limit> previously attached to any structure. 


The SELECT option attaches a new selection-condition to a 
structure», or removes a previous one CSELECT NONE). Any 
embedded data set attached to the structuressay Xi» is 
detached. If NONEe the given structure (Xi) will no longer 
be selected until a new selection condition is specified for 
Xie Also» any structures subordinate to Xi (Xj where j>i) 
widl no Longer be selected. 


The DISPLAY option attaches a new display-list to a 


structures including a new selection condition if desired» or 
removes the previous display-list (DISPLAY NONE). The 
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current Limit will be changed onty if the display-spec 
specifies a new Limit. Similarly» the selection criteria 
CVIA structure and/or AT condition) witt be changed only if 
the display-spec specifies new selection criteria. 


The CLIMIF option attaches anew Limit to a structure or 
removes a previous one (LIMIT NONE). - . 


The REPEAT option attaches a new repeat-spec to a structures 
or removes a previous one (REPEAT NONE). 


The SORT option attaches 4 new <sort-spec> to a structure» or 
removes a previous one (SORT NONE). 


The SET statement does not» by itself» select any new records 
or display any items. However» any structure whose 
selection~condittaon is changed or removed is marked as having 
no current record selected. . 


The meaning of a subsequent NEXT (giving no structure-id) may 
be affected by changing the setection. condition of a 
structure. If NEXT means NEXT Xj» j>i» thens 


ae After SET Xi TQ SELECT <setect-spec>» NEXT behaves like 
REPEAT Xi3 | 


bs After SET Xi TO SELECT NONE» NEXT behaves Like NEXT Xi-t. 


Notes For syntax of <select-spec> and <disptay=-spec> see 


SELECTION“CRITERIA. For syntax of <sort“spec> see 
SORT-OPTION. 


er i 
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SHOu 

-- i i 


Pe = ALL meee e ete n ee en cen e ese enn eenen-=>] 


be = DATASETS s2rer eee n nnn n rene nnn nnn n ne => 


i ' 
{o-* DEFINES eve ewer en es ewes usa wenewtanmanaa)y j 
i i i i 
' | fe~ <id> <->] 4 ‘ 
i i 
mm= VIRTUALS oor ne ene n nn nnn nnn nnn n= ===>) 
| i 
l--© GENERATES ------------- eon eeene nnn] 
i 
Im DECLARATIONS --cene nnn ene nann- nn nn ==> 
1 | 7 
I--- <identifier> ----------------------->] 
1 1 it 


i fee- SETS -->10 1 
i ¢ | ui 
i Fe-- ITEMS ->! 1 
t { 
I Keene cee e ern e en een 4 eee sennnenenn{ 


1.. SHOW» by itself» will display the text in the current text 
buffer. 


2e SHOW ALL witl disptay the DASDL description of the accessible 
data base. 


3. SHGW DATASETS will display the names of all data sets in the 
accessible data base. : 


4. SHGW DEFINES will display the names and text asscciated with 
atl defines. If the <id> option is used» the text for only 
that id will be disptiayed. 


5- SHOW VIRTUALS will acSptay the names and text associated with 
all virtual items 


6. SHGW GENERATES witl disolay the names and text associated 
with all temporary sets. 


7. SHOW OECLARATIONS will display the names and text associated 
with all GENERATE» VIRTUAL and DEFINE identifiers. 


8. SHOW <identifier> witt:- 


ae If the <identifier> is the name of an _ accessible data 
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9 


10. 


sets then the system will display: 


1. Att sets and subsets of. the data set including the 
names of keys and data in key items. 


2. The names and description of all items in the data 
set. 


b. If the <identifier> is the name of a set» then the owner 
of the set as well as the keys and data in key items wilt 
be displayed. 


ce If the <identifier> is the name of a data base item then 
the description of alt items by that name witl be 
displayed as wetl as the owner data set of each item. 


SHOW <identifier> SETE wilt display the sets of the 
identifier» which must be a data set name. 


SHOW <identifier> ITEMS with display the names ,. and 


description of att items of the identifier» which must be a 


data set. 


De © 
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SORT 
SORT aeaaoe ee nm ee mee ee a a oe oo Sen te Rae ae SS em ee on eS f 
oo r ] 
{ J cw ew ee oer eann nan eeane p Bowen enwanoneonra { { 


ti a | 
1 a | 
{-- = a a | 


1. Entering SORT with no other option will display the current 
values for SGRT CORE. 


2. SORT jis used to specify the system resources to be used when 
called for by the SORT Option of the DISPLAY verb. 


3- The value of SORT CORE defaults to the SORT/VSORT default of 
8,000 bytes. 


le 


Ge 


Ze 
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TERMINAL 
TERMI NAL. See sess SSH aes ees Ss wens anew en was enen aman eames ==> Z 
- i i 


Sala atalalaletatataaelataletalatatatell Mlatalatelatatatetatatatalataatetatelatetatatatel 
i ar | 
be<5 (PAGE SSeS tees Sass es sxieeeeine<s <i nteger > ===>) 
i i ( t i 


be-= WIDTH eoe-e9>t em = mnt { 
’ i 
Im-- SCREEN weocetenmenrennn= TRUE se ecc eer nenn-2=>! 
i i ot i i 
ae t-- = <->1 I> FALSE =>! i 
‘i f 
dete FORMAT 22s nme en ennnnne HEADING so eeenn nn -->I 
' to | 2 
Im- = 22>) I= TAB <---> : 


f-- SINGLE ->14 


TERMINAL allows the user to display or atter terminal 
attributes. . ; 


Entering FERMINAL with no other opttons witl result iin 
dgsplaying the current terminat settings. . 


SCREEN is TRUE for CRT deVvices» otherwise it is FALSE. 
PAGE is the number of Lines per screen for CRT devices. 


WIOTH is the number of characters per line. Some terminals 
are desitgned such that printing in the last character 
position of the line will cause an automatic line advance. 
The effects of this is that consecutive output will appear to 
be double spaced. This can be avoided by setting LINE to one 
fess character position. 


The system sets the values for SCREEN» PAGE and LINE to those 
of the terminal when CMS/INQUIRY is started. 


The FORMAT option contrals the way data is formatted on the 
users terminal. See OUTPUT FORMATTING for a discussion of 
the FORMAT attributes. 


These terminal attributes are active only if OPTICN is 
TERMINAL. ; 


oo ieee? ya 
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VIRTUAL 

VIRTUAL ==~ <virtual-id> ------n2ennnnnnnnnnn- = <= <aexp> --># 


1. The VIRTUAL statement establishes the given id as a virtual 
item. It has the value of the given arithmetic expression. 


2- The virtual item can be used in either the displaycritem-list 
or in a selection condition. 


3- The arithmetic primarys appearing in <aexp> must be such that 
when the virtual ts referenced in a display list or selection 
conditions the ttems in <aexp> must either be in the record 
being selected or in data sets having current records. 

4. See SELECTION“CONDITION for syntax of <aexp>. 


5- The arithmetic expression for an established virtual may be 
changed only by 


ae CLEAR VIRTUAL and re-entering» or 


be. RECALL VIRTUAL» EDITing and REPEA Ting. 


ATL 
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APPENDIX A = USE OF IHE INQUIRY SYSTEY 


QVERALL STRUCTURE 
OMS INQUIRY consists of three basic components: 


1. DMS/BUILDING» the BUILD INQUIRY programs» which must be run 
first to set up necessary information in the INQUIRY CONTROL 
file» <database~name>/INQCTL. It will take designation of a 
logical database on the system as inputs along with an 
optional set of valid system usercodes qualified to view the 


database. In addition» the program wilt accept input 
describing various parameters to enable the INQUIRY program 
to run more efficiently. Using the database dictionary 


created by the DASDL compile for the physical database 
containing the togical database» BUILD INQUIRY will create 
the INQUIRY CONTROL file. The -file contains necessary 
information for control of the INQUIRY program and “is 
associated only with this logical database. 


Ze DM¥S/INQUIRY» the second component of the system» is the 
INQUIRY program itself. A copy of. this program will exist 
for every user running INQUIRY on the system. The program 
Will ask the user for the name of the database which the user 
wants to inquire agatnst and ensure that he is a valid user 
of that database. Reading the INQUIRY CONTROL file to get a 
description of the database» the program will initialize its 
internal tables and begin processing against the database. 
ALL INQUIRY processing is done by this program» and all 
INQUIRY code is shareable. 


3. ODMS/HELPINQ» the third components» is a data file which must 
be present in order for the HELP verb to function properly. 


TERMINAL TYPES 


The INQUIRY system will run on any terminal configuration which 
supports CANDE and SMCS Cieee» TO829» TO830e TTY). 


RUNNING ENVIRONMENTS 


Both OMS/INQUIRY and OMS/BUILDING may. be run alone or under a 
message control system. When run. alone (Ciee.s» with only a 
datacomm handler) the program must be executed from the SPQ and 
the internal file “REMOQTE™ must be equated to the file name of 
the station on which the program wilt be run. For example, if 
OMS/BUILDINOG is to be run on station 14 having a remote file name 
of S14- the following should be entered from the SPQ: 


TEX DMS/ BUILDING FILE REMOTE NANE S145 
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When running under an WCS such as SMCS» no file 
required. The user enters: ; 


EX DMS/BUILODING or» in the case of SMCS: 
SIGN ON DMS/BUILDING | 


Invocation of security witl cause a change in the 
execution. See the section labelled SECURITY. 


equation is 


manner of 


A~ > 
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BUILO INQUIRY CONS/BUILODING) 


The BUILD INQUIRY program may be run from a terminal or as a 
batch job taking input from a card file. The source of input is 
controlled by program switch 4. If SWO=0 terminal input is 
expected, otherwise» acard input file (Clabeltled CARDS) is 
expected. 


When taking inout from a terminals» the programa will initiate a 
dialogue to determine what functions it is to perform. With the 
user running under SMCS» the dialogue is as follows: 
1. User enters “SIGN ON OMS/BUILDINO® | 
2.- The program responds with: 
“BUILD INQUIRY VERSION X.X MM/DD/YY" 
and asks: 
“DATA BASE NAME?" 
Legal responses are: 


>e7= <database name> aww acetates wwe sen wacom wna mawaacawe= > f 


i | 
Im-- ON ew <packwid> <--->] 


Inf the <database name> does not exists or the syntax of the 
expression is incorrects the program will respond with an 
error message and recommence the dialogue. If a nutl input 
is entered» the BUILDING program with terminate. 


3- Given an existing physical databases the program will query: 
“TOTAL OR LOGICAL DATABASE?™ 


Legal responses. are: 


» lahat ated delete atthe tteetetetaer beteeatnehetetaatahetes oeces~ were orem ewoen=> ff 
a i 
I--- LOGICAL --->1 
{ i 
bm-- TOTAL ----->1 


‘If the user specifies "LOGICAL", the system wilt respond 
with: 


“LOGICAL DATABASE NAME?" | 


The user must respond with a logical database existing within 
this physical database. Note that when a togical database 
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name is spect fied» the INQUIRY CONTROL file will be generated 
with a multi~file id containing the tlogicat (not physical) 
database name. If the user specifies “TOTAL™"» the entire 
database wilt be used. 


Iff a null input is entered» the dialogue is aborted (without 
creating a control file) dnd recommences at step 2. 


4e After determining which database is to be accessed» the 
peogram will asks . 


“PACK FOR INQUIRY CONTROL FILE?" 
If the INQCTL file is to reside on a pack-..other than the 
system pack» that packrid should be given. A null itnput 
indicates that the control file will reside on the same pack 
as the dictionary. 
Se The next question is: 


“TIMEGUT TIME?" 


DMS/INQUIRY will tog off a user whose terminal remains 


inactive for a certain length of time. This gives the DBA a 
chance to specify a defauit for atl inquiry users of this 
logical database. Response should be time in minutes>s 
greater than 09 and tess than 999. A null tinput assumes 


defautts which is i5 minutes. 


6.- The user now must specify whether or not access is to be 
restricted to the inquiry programs. The question 


“SECURITY? CY/N)" 


should be answered with a “Y*" if restricted access to certain 
usercodes is desired (see SECURITY)... 


If security 1s desired» the user then must supply” the 
usercodes which are to be allowed to run DMS/INQUIRY against 
this database. This is specified by: 


i. ( 


The control file "“<diname>/INQCIL™ is built from this 
informations and the dialogue toops back to step 2» where a new 
database may be specified. In this wayr any number of inquiry 
contrael files can be set up during one terminal session. 


To run. from cards» the following deck must be used: 
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ZEX DMS/BUILDINGA 
2DA CARDS 
<card input» 
ZEND 
Card input wilt be free-formatys one input per card» and must 
conform to the following diagram: 


DATABASE 7-- = f=" Cphysical wer ew ewe sewer erceesesones 5 ==>> 
database name> 1 i 
i-- ON <packtid> -=->! 


a>" LUGCICAL = t24 e822 84ssee%"= = =< <logicat database “-- 3; 27->> 
q | name> 
§$-- DATABASE. -~>I 


>»>@< PACK a ee : = * a eeweent <pack-id> sweceeewoeneeees 3 = =>> 


>>4 TIMEQUT oone- = eeenenm- cinteger> sneer eennn----- 5 >> 
I<ceene 5 cnnnnen] 
i { 
>>- USERCODES 9-2 = serene n--- <usercode> ----------- - 3 ---># 
SECURITY 


Security in the form of usercode checking is available in the 
INQUIRY system. This checking can be invoked when the BUILD 
INQUIRY program is run (see above). When invoking security» the 
DMS/BUILDINQ program should be run under a public»e privileged 
usercode. The control file is created read only» without a 
usercode. Any user wishing to use the INQUIRY system through 
this control file must have a tlegat usercode associated with 
execution of the DMS/INQUIRY program. 


FILME QUT 


If a user's terminal remains inactive for a specified length of 
time (specified in BUILO/INQUIRY)» INQUIRY will terminate that 
user and go to EQJ. If DEFINES» VIRTUALS» or GENERATES extst 
which have not been saved» they witl be saved in a file named 
"TIMEQUTXXX"» where XXX is the LON of the terminal that the user 
Was running one . 
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ONS INSUIRY CUDNS/INGUIRY") 


After creating an inquiry control file with OMS/BUILDINOG> the 
user may run DMS/INQUIRY against the database. DMS/INQUIRY will 
be able to run on any ‘system which wilt support CANDE» and witl. 
run on any terminal which CANDE services. OMS/INQUIRY may be run 
either through a Message Control System (MCS) or alone. If it is 
run alones the progras must be initiated from the SPO» and file 
equated to the inquiry remote fite "REMOTE" to the desired 
station. For examples to run on station #414 with a logical name 
of S14» enter: 


ZEX DMS/INQUIRY FI REMOTE NAME S145. 


If run under an MCS» (such as SMCS)»  #$=no file equation is 
required. Simply enter: 


2EX DMS/INQUIRY 


Once the program tS running» it wilt print a header message 
notifying the user of the version and compile date of the prograw 
being useds - 


81809781700 DHS/INQUIRY VERSION X.X CMM/DD/YY) 
WHAT DATABASE? 


The user replies with the name of the database he is inquiring 
into (Cif the database nawe contains any non-alohabetic 
characters,» it must be enclosed in quotes). If a controt file 
for the database exists» a check of his usercode is made Cif 
security has been specified at BUILDING time). If the usercode 


is vatid (specified at S8BUILDING@ time)». access is ‘granted. 
Otherwiser access is refused. The reply must be formatted as 
foilows: 

i i 


I--- ON --- <pack-id> --->1 
If access is granted» the program responds with: 
INITIALIZING.»«sPLEASE WAIT... 


The user is notified when initialization is complete by the 
wessage: , ; | 


oe eREADY 
t 


and processing may begin. 
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TESTING ECATURE 


In order to ease testing of DMS/INQUIRY» a feature has been added 
to enable input to be entered on cards exactly as it would be 
entered through the terminal. This file is called "COMMANDS" and 
is assumed to be a serial file containing DMS/INQUIRY 
instructions. This capability is controtled by progres s¥iten 9. 
To use this feature: 


EX OMS/INQUIRY FI COMMANDS NAME CARDSs SW9=1;5 


A card fife named "CARDS" wittl be expected as primary input. 
Output can be directed to disk by setting the PRINTER option in 
OMS/INQUIRY and file equating the file "LINE™ to.a disk file at 
execution time. 


NOTE: This feature is intended for use only by the Santa Sarbara 
facility. ; 
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PERFORMANCE CHARACTERISTICS 


Any performance prediction is» at best» a risky affair. kKhile 
this design has attempted to minimize data and code spaces a5 
well as execution time» perfermance of the inquiry system could 
wary dramatically depending on many- factors; ees memory 
Capacity of the system» the mnusber of concurrently running jobs» 
the design and size of the database» and the DMS INQUIRY 
constructs used to obtain the desired information. 


This design also attempts to reduce the amount of static memory 


requtred to run the program. By placing’ most data in dynamic 
memory» the user is allowed a certain amount of controt over 
run-time meaory requirements not otherwise possible. 


Execution-time specification of dynamic memory space requirements 
attows the inquiry program to utilize as much memory as possible 
in any situation. This ‘should have a positive effect on the 
performance of the system. ° ' 


The design of the database could have a profound effect on the 
performance of DMS INQUIRY. Utilization of existing structures 
in the database will, in general» result in much better 
performance than use of OMS INQUIRY capabilities which do not 
take advantage of the database structure. The size of the 
database» both in population and in number of items» wilt also 
affect performance. The former increases the time used by the 
MCP to retrieve records for the inquiry process» while the latter 
increases the size and coaplexity of the inquiry program's 
internal database description. 


Thirdly» the constructs used for inquiry purposes with have an 
effect on per formance. Some constructs» such as SORT» require 
that the entire data set be tlooked at and sorted tefore = any 
response appears to the usere Conversely» simple incuiries using 


existing index sets wiil result in better response. 
Additionalty» overenthusiastic. use of virtual items» temporary 
sets» and defines will have a negative impact on processing 


speed. In general>» the simpler an inquiry is» the more 
satisfactory the performance will be. : 


In summary» optimal performance would probably be obtained under 
the following conditions: 
1. Maximum dynamic memory space should be allocated for 


the inquiry program. 


Ze The object togical database - should contain no more 
datasets than required. 


ss Inquiries should te siaply constructed» and shoutd 
follow existing index sets. ; 
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4e Obviously» other programs in the mix could have a 
negative effect cn the inquiry program's performance. 
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